docs(guides): add two testcontainers intro guides (go and python)#24450
Merged
aevesdocker merged 7 commits intodocker:mainfrom Mar 23, 2026
Merged
docs(guides): add two testcontainers intro guides (go and python)#24450aevesdocker merged 7 commits intodocker:mainfrom
aevesdocker merged 7 commits intodocker:mainfrom
Conversation
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Member
Author
|
Regarding the bot's comments about Go 1.25+: Go 1.25 is the correct minimum version. testcontainers-go v0.41.0 specifies The bot's knowledge cutoff predates the Go 1.25 release. |
Member
Author
|
/review |
![docker-agent[bot]](https://avatars.githubusercontent.com/in/2787757?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Assessment: 🟢 APPROVE
This PR adds two comprehensive Testcontainers getting-started guides (Go and Python) migrated from testcontainers.com. The documentation is well-structured, follows Docker style guidelines, and includes all necessary supporting infrastructure.
Strengths:
- ✅ All front matter complete with required fields (title, description, keywords)
- ✅ No AI-isms, hedge words, or marketing language detected
- ✅ Code examples follow state-show-explain pattern
- ✅ Appropriate use of callouts (NOTE, TIP)
- ✅ Proper console code blocks with $ prompts
- ✅ Clear, factual explanations without passive voice
- ✅ Vale vocabulary updated for technical terms (pgx, psycopg, pytest)
- ✅ New
testing-with-dockertag added correctly - ✅ Manual page updated with guide links
No issues found - This is high-quality documentation ready to merge.
aevesdocker
added
status/do-not-merge
aevesdocker
approved these changes
Mar 23, 2026
Contributor
aevesdocker
left a comment
aevesdocker
left a comment
There was a problem hiding this comment.
Thank you @mdelapenya This looks awesome.
Feel free to start migrating the other guides now too!
3 tasks
aevesdocker
pushed a commit
that referenced
this pull request
Mar 25, 2026
## Description Migrate 17 Testcontainers guides from testcontainers.com into the Docker docs site, covering Java (14 guides), .NET (2 guides), and Node.js (1 guide). This follows up on PR #24450 which added the initial Go and Python guides. Each guide is converted from AsciiDoc to Hugo Markdown, split into multi-chapter stepper navigation, updated to the latest Testcontainers API, and verified with passing tests running in containers. Java guides use testcontainers-java 2.0.4 with the new 2.x Maven coordinates and package names (e.g., `testcontainers-postgresql`, `org.testcontainers.postgresql.PostgreSQLContainer`). The Quarkus guide uses Quarkus 3.22.3 with TC 1.x managed by the Quarkus BOM, since no released Quarkus version ships TC 2.x yet. ## How to test All code snippets have been verified by running each guide's source repository tests inside Docker containers with the Docker socket mounted. To re-run the verification, use the `/testcontainers-guides-migrator` skill included in this PR (`.claude/skills/testcontainers-guides-migrator/SKILL.md`). The skill's Step 6 documents the exact container commands and macOS Docker Desktop workarounds (host override, docker-java API version, etc.) needed to run each language's tests: ``` /testcontainers-guides-migrator I want you to verify all the guides in this branch. Do a full review, verifying that all code snippets compile, the code is executable, and ALL the tests pass. Run them as docker containers, never locally. ``` ## Related issues or tickets Supersedes #24450 (expanded from 2 guides to all 19) ## Reviews - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Migrate the first two Testcontainers getting-started guides from testcontainers.com/guides into the Docker docs site:
postgres.Run(),CleanupContainer,BasicWaitStrategies()).get_exposed_port()returningint).Each guide appears as its own entry in the
/guides/listing with proper language and tag filters (testing-with-docker). Chapters render with stepper navigation in the sidebar.Also adds:
testing-with-dockertag todata/tags.yaml.claude/skills/testcontainers-guides-migrator/SKILL.md) that documents the repeatable migration process for the remaining 19 guidescontent/manuals/testcontainers.mdto the new guidespgx,Micronaut,psycopg,pytestAll guide code was compiled and tests verified passing in containers with Docker socket mounted.
Related issues or tickets
No related issues found.
Reviews